home *** CD-ROM | disk | FTP | other *** search
/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / splash / readme < prev    next >
Text File  |  1993-07-25  |  5KB  |  132 lines
  1. Date:  Sep 24, 1992.
  2.  
  3. This is the directory for the Stanford Parallel Applications for Shared-Memory
  4. (SPLASH) programs. For further information contact splash@mojave.stanford.edu.
  5.  
  6. PLEASE NOTE:  Owing to our limited resources, we will be unable to spend 
  7. much time answering questions about the applications.  
  8.  
  9. splash.tar.Z contains the tared and compressed version of all the files.
  10. Grabbing this file will get you everything you need.  We also keep the files
  11. individually uncompressed for partial retrieval.
  12.  
  13. REPORT:
  14. -------
  15.  
  16. Please note that the report, found in the report subdirectory, is 42 pages 
  17. long.  Please check to see that you get them all when you print the 
  18. postscript file.  The size of the postscript file is 694769 bytes.  If the 
  19. size is right and it doesn't print all the pages, you may have to modify 
  20. the header of the postscript file to adapt it to your system.  Some people 
  21. still have a problem printing the postscript file.  We therefore provide
  22. the Latex sources and the postscript files for the figures (in the
  23. report subdirectory) so that you can remake the postscript and print it.   
  24. Finally, if all else fails the tech report can be requested by sending 
  25. mail to schulman@sierra.Stanford.EDU.  The tech report number is 
  26. CSL-TR-92-526, dated June 1992.  The original tech
  27. report was number CSL-TR-91-469, but this is somewhat dated.  We will issue
  28. a new tech report when there are major changes to the suite (new applications,
  29. etc.).  However, the latest version of the report is always on-line.
  30.  
  31. MACROS:
  32. -------
  33.  
  34. In the macros directory, we provide macros and sample makefiles
  35. for three machines:
  36.  
  37. Encore Multimax (CMU Mach 2.5: C and Fortran)
  38. SGI 4D/240     (IRIX System V Release 3.3: C only) 
  39. Alliant FX/8    (Alliant Rev. 5.0: C and Fortran)
  40.  
  41. These macros work for us with the above operating systems.  Unfortunately,
  42. our limited resources prevent us from supporting them in any way or 
  43. even fielding questions about them.   If they don't work for you, please
  44. contact Argonne National Labs for a version that will.  An e-mail address 
  45. to try might be monitor-users-request@mcs.anl.gov. An excerpt from
  46. a message, received from Argonne, concerning getting the macros follows:
  47.  
  48. "The parmacs package is in the public domain.  Approximately 15 people at
  49. Argonne (or associated with Argonne or students) have worked on the parmacs
  50. package at one time or another.  The parmacs package is implemented via macros
  51. using the M4 macropreprocessor (standard on most Unix systems).  Current
  52. distribution of the software is somewhat ad hoc.  Most C versions can be
  53. obtained from netlib (send electronic mail to netlib@ornl.gov with the message
  54. send index from parmacs).  Fortran versions have been emailed directly or sent
  55. on tape.  The primary documentation for the parmacs package is the book
  56. ``Portable Programs for Parallel Processors'' by Lusk, et al, Holt, Rinehart,
  57. and Winston 1987."
  58.  
  59. The makefiles provided in the individual program directories specify
  60. a null macro set that will turn the parallel programs into sequential 
  61. ones.  Note that we do not have a null macro set for FORTRAN.
  62.  
  63. MAILING LIST:
  64. -------------
  65.  
  66. Please send a note to splash@mojave if you have copied over the programs,
  67. so that we can put you on a mailing list for update reports.
  68.  
  69. CHANGES:
  70. -------
  71.  
  72. June 5, 1991.  
  73. ------------
  74.     1. The NEWPROC and PAUSEDEC macros have been removed.
  75.     2. The file adv.U in mp3d has been updated to fix a boundary
  76.            condition.
  77.         3. The ocean program has been updated with a new initial guess
  78.            to the equation solver to improve its convergence.  A new 
  79.        parameter has been added to the solver routine, and the calls 
  80.        to it have correspondingly changed.
  81.  
  82. June 13, 1991.  
  83. -------------
  84.      1. For mp3d, Global->BC is now initialized to 0 in setup.U.
  85.      2. Next version of tech report complete.
  86.  
  87. July 31, 1991.
  88. -------------
  89.     1. Small update made to mp3d section of report. Concerns number
  90.        of time-steps run with simulator.
  91.         2. Water source code updated with comments to describe input
  92.        parmeters better.
  93.  
  94. Aug. 6, 1991.
  95. ------------
  96.     1. Bug in water fixed.  Some interactions were not being 
  97.            examined correctly and a barrier was missing.  Some other 
  98.        minor cleanup done in water.
  99.         2. A new version of pthor created.  It primarily improves 
  100.        cache mapping behaviour.  See README file in pthor 
  101.        directory.
  102.         3. Reference to paper on data locality and memory system 
  103.        performance in Ocean added.
  104.  
  105. Aug. 28, 1991
  106. -------------
  107.     1. Locking bug in mp3d fixed. Caused null pointer dereferencing
  108.        on some machines.
  109.  
  110. May 29, 1992
  111. ------------
  112.     1. New application (Barnes-Hut) added.
  113.     2. Report updated accordingly. Section 4.2 on general behavioral
  114.        characteristics cleaned up and enhanced somewhat.
  115.        Also, indication given of how to scale some of the 
  116.        scientific applications to run on larger machines.
  117.  
  118. July 24, 1992
  119. -------------
  120.  
  121.     1. Some bugs in water fixed:
  122.         a) determining when comp_last should be decremented
  123.                to compute interactions correctly in interf.U and
  124.            poteng.U fixed.
  125.         b) a race condition between initializing and accumulating
  126.            into gl->VIR removed.  A new variable called
  127.            gl->initialized introduced to do this.
  128.         c) the code will not crash if input variable NFMC is
  129.            set to 0 and the input displacement file LWI12 (not
  130.            needed in this case) not provided.
  131.  
  132.